Resolutions Registry entry

Specify what resolutions are automatically generated when an image is added to a Multimedia record.

Usage

This Registry entry can be assigned to users, groups and system-wide:

Key User Group Key System
Key 1 User Group Key 1 System
Key 2 user group Key 2 Setting
Key 3 Setting Key 3 Multimedia
Key 4 Multimedia Key 4 Resolutions
Key 5 Resolutions Key 5 format or Default
Key 6 format or Default    
Value generate;generate;... Value generate;generate;...

where:

format

is the format of an image added to a Multimedia record; or use Default for any image format added to a Multimedia record.

Image formats recognised by EMu include:

BMP

Windows bitmap format (.bmp)

GIF

Graphics Interchange format (.gif)

JPEG

Joint Photographic Experts Group (.jpeg, .jpg)

PCX

ZSoft Paint (.pcx)

PNG

Portable Network Graphics (.png)

TGA

Targa (.tga)

TIFF

Tag Image File Format (.tif, .tiff) with the following compressions:

  • None - No compression
  • Fax3 - CCITT Group 3
  • Fax4 - CCITT Group 4
  • LZW
  • PackBits

Other image formats are supported via external viewers. If an image format is not supported internally, a placeholder icon will display wherever the media is shown. Double-clicking the icon will launch an associated external viewer (as defined in the Windows Registry). EMu also provides support for image translation between any of the formats listed above. Other formats may be translated by external programs either on the client machine or the EMu server.

generate; generate;...

is a semicolon separated list of image specifications to be generated in the format:

width:height:format[:scaled[:enlarge[:compression]]]:quality

where:

width

is the width of the image to be generated in pixels. If the image is not scaled, this is the actual width. For scaled images this is the maximum width. A value of 0 sets the width to the same as the original image.

height

is the height of the image to be generated in pixels. If the image is not scaled, this is the actual height. For scaled images this is the maximum height. A value of 0 sets the height to the same as the original image.

format

is the format of the image to generate. Available values are:

  • BMP
  • GIF
  • JPG
  • JPEG
  • PCX
  • PNG
  • TGA
  • TIF
  • TIFF

scaled

is optional. Takes a value of true or false. If scaled is true, the aspect ratio of the original image will be maintained. This means that either the width or height will be adjusted automatically to ensure the image is not "stretched". If scaled is false, the image will be "stretched" to fill the specified width and height. If this property is not defined, scaling is enabled.

enlarge

is optional. Takes a value of true or false. If enlarge is true, the image will be generated even if the width and / or height are larger than the original image. This may result in image pixilation. A false value will not generate an image if the resulting image would be larger than the original. If this property is not defined, enlarge is enabled.

compression

is the internal compression to be used for storing the image. Alternative compressions are only available for TIFF format. The available values are:

  • None
  • FAX3
  • FAX4
  • LZW
  • PACKBITS

    The default value for TIFF images is None.

quality

is a compression quality value for jpeg / jpg formatted images. A value between 100 and 1 is allowed, where 100 is lossless compression and 1 very lossy compression. If no value is entered, a value of 100 (i.e. lossless) is assumed. See second entry below.

Examples

This entry specifies the creation of two additional images when an image is added to a Multimedia record. The first is a JPEG image, 640 pixels wide by 480 pixels high, where the aspect ratio is maintained and the image may be enlarged if the original is smaller than 640 x 480 pixels. The second image is a PNG image, 150 pixels wide by 150 pixels high, where the aspect ratio is not maintained (i.e. the image may become distorted) and enlargement is possible:

Key Setting
Key 1 System
Key 2 Setting
Key 3 Multimedia
Key 4 Resolutions
Key 5 Default
Value 640:480:JPG:TRUE:TRUE;150:150:PNG:FALSE:TRUE

Note: The standard EMu thumbnail image is still generated.

The first image may be used as the "full size" image on a website, whereas the second may be a "thumbnail" image for a website. Note that the standard EMu thumbnail image would still be generated. It is effectively an entry in the format 90:90:JPG:TRUE:TRUE.

This entry will also generate two images. The first is a 600x800 JPG with a compression quality of 85%:

Key Setting
Key 1 System
Key 2 Setting
Key 3 Multimedia
Key 4 Resolutions
Key 5 Default
Value 600:800:JPG:TRUE:FALSE:NONE:85;300:400:jpg:TRUE